📚 GUÍA COMPLETA - PRÁCTICA EXAMEN UNIDAD 1

🎯 OBJETIVOS DE APRENDIZAJE

Al completar esta práctica, el estudiante será capaz de:

• ✅ Instalar y configurar un entorno de desarrollo Python con Django
• ✅ Crear y estructurar un proyecto Django siguiendo mejores prácticas
• ✅ Conectar Django con una base de datos MySQL
• ✅ Diseñar modelos de datos y realizar migraciones
• ✅ Implementar vistas basadas en funciones y clases
• ✅ Crear templates con el sistema de plantillas de Django
• ✅ Utilizar Git y GitHub para control de versiones
• ✅ Desplegar una aplicación Django en PythonAnywhere

💻 REQUISITOS PREVIOS

Software Necesario:

• Python 3.10+ o superior
• MySQL Server 8.0+ o superior
• Git
• VS Code (editor recomendado)
• Navegador web moderno

Cuentas Requeridas:

• Cuenta de GitHub (gratuita) - github.com
• Cuenta de PythonAnywhere (gratuita) - pythonanywhere.com

📦 PARTE 1: CONFIGURACIÓN DEL ENTORNO

Paso 1.1: Verificar Instalación de Python

# Abrir PowerShell como Administrador

# Verificar versión de Python
python --version
# Salida esperada: Python 3.10.x o superior

# Verificar pip
pip --version

Paso 1.2: Crear Directorio del Proyecto

# Crear carpeta para el proyecto
mkdir D:\Proyectos\biblioteca_django
cd D:\Proyectos\biblioteca_django

Paso 1.3: Crear Entorno Virtual

# Crear entorno virtual
python -m venv venv

# Activar el entorno virtual (Windows)
.\venv\Scripts\Activate

# Verificar activación (debe aparecer (venv) al inicio del prompt)

Paso 1.4: Instalar Django y Dependencias

# Actualizar pip
python -m pip install --upgrade pip

# Instalar Django
pip install Django==4.2

# Instalar conector MySQL
pip install mysqlclient

# Instalar otras dependencias
pip install pillow

# Crear archivo requirements.txt
pip freeze > requirements.txt

🏗️ PARTE 2: CREACIÓN DEL PROYECTO DJANGO

Paso 2.1: Crear Proyecto Django

# Crear proyecto
django-admin startproject biblioteca_project .

# Verificar estructura creada
dir

Paso 2.2: Crear Aplicación "libros"

# Crear aplicación
python manage.py startapp libros

Paso 2.3: Registrar la Aplicación

Editar biblioteca_project/settings.py:

# Localizar INSTALLED_APPS y agregar 'libros'

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'libros',  # ← AGREGAR ESTA LÍNEA
]

🗄️ PARTE 3: CONFIGURACIÓN DE MYSQL

Paso 3.1: Crear Base de Datos en MySQL

-- Abrir MySQL Workbench o línea de comandos MySQL

-- Crear base de datos
CREATE DATABASE biblioteca_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Crear usuario y otorgar privilegios
CREATE USER 'biblioteca_user'@'localhost' IDENTIFIED BY 'Pass123456!';
GRANT ALL PRIVILEGES ON biblioteca_db.* TO 'biblioteca_user'@'localhost';
FLUSH PRIVILEGES;

-- Verificar creación
SHOW DATABASES;
SELECT user FROM mysql.user WHERE user='biblioteca_user';

Paso 3.2: Configurar Archivo .env

Crear archivo .env en la raíz del proyecto donde esta ubicado el archivo manage.py:

# Configuración de Base de Datos
DB_NAME=biblioteca_db
DB_USER=biblioteca_user
DB_PASSWORD=Pass123456!
DB_HOST=localhost
DB_PORT=3306

# Configuración de Django
SECRET_KEY=django-insecure-tu-clave-secreta-aqui-cambiar-en-produccion # esta clave se encuentra en el archivo settings.py
DEBUG=True

Paso 3.3: Configurar settings.py para MySQL

Editar biblioteca_project/settings.py:

                    
import os
from pathlib import Path
import environ # Asegúrate de tener esto

# 1. Definir la ruta base del proyecto
BASE_DIR = Path(__file__).resolve().parent.parent

# 2. Inicializar environ y asignarlo a la variable 'config' 
# (Aquí es donde ocurre la magia: llamamos 'config' al objeto env)
config = environ.Env()

# 3. Leer el archivo .env
environ.Env.read_env(os.path.join(BASE_DIR, '.env'))

# --- Ahora tus líneas siguientes funcionarán ---
SECRET_KEY = config('SECRET_KEY')
DEBUG = config('DEBUG', default=False, cast=bool)

# ... más abajo en el archivo, reemplazar DATABASES

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': config('DB_NAME'),
        'USER': config('DB_USER'),
        'PASSWORD': config('DB_PASSWORD'),
        'HOST': config('DB_HOST', default='localhost'),
        'PORT': config('DB_PORT', default='3306'),
        'OPTIONS': {
            'charset': 'utf8mb4',
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}

# Configuración de idioma y zona horaria
LANGUAGE_CODE = 'es-mx'
TIME_ZONE = 'America/Mexico_City'
USE_I18N = True
USE_TZ = True

# Instala la librería: Ejecuta el siguiente comando para instalar el paquete necesario:
pip install django-environ

#Verifica la instalación: Para estar seguro de que ahora sí existe en tu entorno, puedes listar los paquetes instalados:
pip list

# Tip adicional: Si tienes un archivo llamado requirements.txt en tu proyecto, lo ideal es ejecutar:
pip install -r requirements.txt

Paso 3.4: Verificar Conexión

# Probar conexión a la base de datos
python manage.py check
# Salida esperada: System check identified no issues (0 silenced).

📊 PARTE 4: MODELOS Y BASE DE DATOS

Para implementar estos modelos en Django, utilizaremos campos específicos para cada tipo de dato 
(fechas, correos, imágenes, etc.) y definiremos las relaciones necesarias como ForeignKey (FK) 
y ManyToManyField (M2M).

Aquí tienes el código para libros/models.py:

*** Codigo Python *****

from django.db import models

class Autor(models.Model):
    nombre = models.CharField(max_length=150)
    fecha_nacimiento = models.DateField()
    pais_origen = models.CharField(max_length=100)
    biografia = models.TextField()
    foto = models.ImageField(upload_to='autores/', null=True, blank=True)

    def __str__(self):
        return self.nombre

class Categoria(models.Model):
    nombre = models.CharField(max_length=100)
    descripcion = models.TextField()
    activa = models.BooleanField(default=True)

    def __str__(self):
        return self.nombre

class Editorial(models.Model):
    nombre = models.CharField(max_length=150)
    pais = models.CharField(max_length=100)
    sitio_web = models.URLField(null=True, blank=True)
    email = models.EmailField()

    def __str__(self):
        return self.nombre

class Libro(models.Model):
    ESTADO_CHOICES = [
        ('disponible', 'Disponible'),
        ('prestado', 'Prestado'),
        ('mantenimiento', 'En Mantenimiento'),
    ]
    
    isbn = models.CharField(max_length=13, unique=True)
    titulo = models.CharField(max_length=255)
    autor = models.ForeignKey(Autor, on_delete=models.CASCADE)
    categorias = models.ManyToManyField(Categoria)
    editorial = models.ForeignKey(Editorial, on_delete=models.SET_NULL, null=True)
    fecha_publicacion = models.DateField()
    numero_paginas = models.PositiveIntegerField()
    sinopsis = models.TextField()
    portada = models.ImageField(upload_to='portadas/', null=True, blank=True)
    precio = models.DecimalField(max_digits=10, decimal_places=2)
    stock = models.PositiveIntegerField(default=0)
    estado = models.CharField(max_length=20, choices=ESTADO_CHOICES, default='disponible')
    calificacion = models.FloatField(default=0.0)

    def __str__(self):
        return self.titulo

class Prestamo(models.Model):
    ESTADO_PRESTAMO = [
        ('activo', 'Activo'),
        ('devuelto', 'Devuelto'),
        ('retrasado', 'Retrasado'),
    ]
    
    libro = models.ForeignKey(Libro, on_delete=models.CASCADE)
    nombre_usuario = models.CharField(max_length=150)
    email_usuario = models.EmailField()
    fecha_prestamo = models.DateTimeField(auto_now_add=True)
    fecha_devolucion_esperada = models.DateField()
    estado = models.CharField(max_length=15, choices=ESTADO_PRESTAMO, default='activo')

    def __str__(self):
        return f"{self.libro.titulo} - {self.nombre_usuario}"

**** Detalles importantes que agregué: *****
on_delete: Es obligatorio en Django para las ForeignKey. Usé CASCADE para que si borras un autor, 
se borren sus libros, y SET_NULL para la editorial para que el libro no desaparezca si la editorial 
es eliminada.

upload_to: Define las carpetas donde se guardarán las fotos 
(necesitarás instalar la librería Pillow con pip install Pillow).

choices: Para los campos "estado", es mejor usar una lista de opciones para evitar errores de escritura.

DecimalField: Para el precio, siempre es mejor usar este campo que un Float para evitar problemas de 
precisión monetaria.

Siguientes pasos:
Asegúrate de tener instalado Pillow (pip install Pillow) para manejar las imágenes.

Ejecuta las migraciones para crear las tablas en la base de datos.

                

Paso 4.2: Crear Migraciones

# Crear archivos de migración
python manage.py makemigrations

Paso 4.3: Aplicar Migraciones

# Aplicar migraciones a la base de datos
python manage.py migrate

Paso 4.4: Crear Superusuario

# Crear superusuario para acceder al admin
python manage.py createsuperuser

# Ingresar datos solicitados:
# Username: admin
# Email: admin@biblioteca.com
# Password: Admin123456!
# Password (again): Admin123456!

🎨 PARTE 5: VISTAS Y URLS

Vistas a Implementar

📱 PARTE 6: TEMPLATES

Estructura de Templates

templates/
├── base/
│   └── base.html          # Template base con navbar y footer
└── libros/
    ├── inicio.html         # Página de inicio
    ├── lista_libros.html   # Lista de libros
    ├── detalle_libro.html  # Detalle de libro
    ├── lista_autores.html  # Lista de autores
    └── detalle_autor.html  # Detalle de autor

Archivos Estáticos

static/
├── css/
│   └── styles.css         # Estilos personalizados
├── js/
│   └── main.js            # JavaScript personalizado
└── images/                # Imágenes del sitio

📂 PARTE 7: CONTROL DE VERSIONES CON GITHUB

Paso 7.1: Configurar Git Localmente

# Configurar nombre de usuario
git config --global user.name "Tu Nombre"

# Configurar email
git config --global user.email "tu.email@ejemplo.com"

# Verificar configuración
git config --list

Paso 7.2: Crear .gitignore

Crear archivo .gitignore:

# Python
*.py[cod]
__pycache__/
*.pyc

# Django
*.log
db.sqlite3
/media
/staticfiles

# Entorno virtual
venv/
env/

# Variables de entorno
.env

# IDEs
.vscode/
.idea/

Paso 7.3: Inicializar Repositorio Git

# Inicializar git
git init

# Agregar todos los archivos
git add .

# Crear primer commit
git commit -m "Initial commit: Proyecto Biblioteca Django con MySQL"

Paso 7.4: Crear Repositorio en GitHub

1. Ir a GitHub.com
2. Iniciar sesión con tu cuenta
3. Crear nuevo repositorio:
   • Clic en "+" → "New repository"
   • Nombre: biblioteca-django-uth
   • Descripción: "Sistema de Biblioteca con Django y MySQL - Práctica Unidad 1"
   • Público o Privado
   • NO inicializar con README, .gitignore o licencia
   • Clic en "Create repository"

Paso 7.5: Conectar Repositorio Local con GitHub

# Agregar remote origin (reemplazar USERNAME con tu usuario)
git remote add origin https://github.com/USERNAME/biblioteca-django-uth.git

# Verificar remote
git remote -v

# Subir código a GitHub
git branch -M main
git push -u origin main

Paso 7.6: Crear README.md

Crear un archivo README.md con:

• Descripción del proyecto
• Tecnologías utilizadas
• Instrucciones de instalación
• Estructura del proyecto
• Información del autor

☁️ PARTE 8: DESPLIEGUE EN PYTHONANYWHERE

Paso 8.1: Crear Cuenta

1. Ir a PythonAnywhere.com
2. Seleccionar plan "Beginner (Free)"
3. Crear cuenta y verificar email

Paso 8.2: Configurar MySQL en PythonAnywhere

1. En Dashboard, ir a "Databases"
2. Crear database: biblioteca_db
3. Anotar: database name, username, password, host

Paso 8.3: Clonar Repositorio

# En Bash console de PythonAnywhere
git clone https://github.com/USERNAME/biblioteca-django-uth.git
cd biblioteca-django-uth

Paso 8.4: Crear Entorno Virtual

# Crear entorno virtual
mkvirtualenv --python=/usr/bin/python3.10 biblioteca_env

# Instalar dependencias
pip install -r requirements.txt

Paso 8.5: Configurar Variables de Entorno

Crear .env con valores de producción:

DB_NAME=USERNAME
DB_USER=USERNAME
DB_PASSWORD=tu_password_mysql
DB_HOST=USERNAME.mysql.pythonanywhere-services.com
DB_PORT=3306
SECRET_KEY=nueva-clave-secreta-para-produccion
DEBUG=False
ALLOWED_HOSTS=USERNAME.pythonanywhere.com

Paso 8.6: Ejecutar Migraciones

python manage.py migrate
python manage.py createsuperuser
python manage.py collectstatic --noinput

Paso 8.7: Configurar Web App

1. Ir a "Web" en Dashboard
2. "Add a new web app"
3. Seleccionar "Manual configuration"
4. Python 3.10
5. Configurar WSGI file
6. Configurar Virtualenv
7. Configurar Static files
8. Recargar aplicación

📊 RÚBRICA DE EVALUACIÓN Y ESPECIFICACIONES

Escala de Calificación

Puntos Extra (Opcional)

✅ LISTA DE VERIFICACIÓN FINAL

Entregables Requeridos

🎓 CONCLUSIÓN

📚 Recursos Adicionales

• Documentación oficial de Django
• Tutorial de Django
• Bootstrap 5 Docs
• MySQL Documentation
• Git Handbook
• PythonAnywhere Help

💡 Consejos Finales

1. Guarda cambios frecuentemente con commits en Git
2. Prueba cada funcionalidad antes de continuar con la siguiente
3. Lee los mensajes de error con atención, te indican el problema
4. Consulta la documentación oficial cuando tengas dudas
5. Pide ayuda si te atascas más de 30 minutos en algo
6. Documenta tu código para tu futuro yo y otros desarrolladores
7. No copies y pegues sin entender - aprende cada línea de código
8. Graba el video con tiempo - no lo dejes para el último momento